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“API AlloCiné v3 


Un nouveau système de signature des appels a été mis en place. RUES 
Un exemple d'utilisation en PHP est dispo sur mon GitHub : https://github.com/gromez/allocine-api. «Recherche : search 


s Informations sur un film : movie 
«Critiques sur un film (presse et 
public) : reviewlist 


Informations -Horaires des cinémas : showtimelist 
-Informations sur une vidéo : media 
@AlloCiné a mis à jour il y a quelques temps ses APIs. ps o i 
Je vais tenter de les expliquer sur cette nouvelle page. «Filmographie d'une personne : 
filmography 
e aA m Peas # A ` Us P; N 4 P : “Liste des films en salle : movielist 
Pour les découvrir, j'ai utilisé le même principe que la première fois. Une petite différence est à noter, il semblerait que la valeur partner a changé depuis. «Liste des cinémas : theaterlist 
4 5 «Informations sur une série TV : 
Sa valeur sera désormais QUNXZWItQWxsb0Npbuk. Dea r e 
s Informations sur la saison d'une 
L'URL de base a, elle aussi, changé : http://api.allocine.fr/rest/v3/ SEVEN 


«Informations sur l'épisode d'une 
série TV : episode 


~Il tde l'API 
Les APIs s1 se servent de 


- Remerciements 
Les différentes APIs s'appellent toutes en GET. Je n'ai pas testé en POST mais si c'est comme avant, ça ne devrait pas marcher. 


Recherche : search 


a Paramètres 

a partner : code partenaire (QUNXZWItOWxsbONpbuk pour l'application Android) 

a q: chaîne à chercher (chaîne de caractères) 

a format (optionnel) : renvoie le résultat au format JSON ou XML (json ou xml) 

a filter (optionnel) : filtrer selon un type de résultat (énumeration de termes séparés par des virgules) 
a movie : afficher les films correspondant à la recherche 
a theater : afficher les cinémas 
a person : afficher les acteurs, réalisateurs, etc. (personnes) 
a news : afficher les news 


a tvseries : afficher les séries TV 
a count (optionnel) : nombre de résultats à renvoyer (entier) 


= Exemple :@rttr://api.allocine.fr/rest/v3/search? 
partner=QUNXZWItOWxsbONpbuks&filter=movie, theater,person,news, tvseries&count=5&page=1&q=avatar&format=json 


a page (optionnel) : numéro de la page de résultats à afficher (10 résultats par page par défaut) 


Informations sur un film : movie 


a Paramètres 
a partner : code partenaire (QUNXZWItOWxsbONpbuk pour l'application Android) 
a code : identifiant du film (entier) 
a profile (optionnel) : degré d'informations renvoyées (valeurs possibles : small, medium, large) 
=a mediafmt (optionnel) : format vidéo 
a flv : FLV / H.264 
= mp4-lc : MP4 / H.264 Baseline Profile, Low Complexity, with splashscreen 
= mp4-hip : H264 High Profile, with splashscreen 
= mp4-archive : MP4 / H.264 High Profile, for archive 
a mpeg2-theater : MPEG-2 720p 
= mpeg2 : MPEG-2 Main Profile 


a et sûrement d'autres mais je n'ai pas le code correspondant ... 


a filter (optionnel) : filtrer selon un type de résultat (énumeration de termes séparés par des virgules) 
a movie : afficher les films correspondant à la recherche 
a theater : afficher les cinémas 
a person : afficher les acteurs, réalisateurs, etc. (personnes) 
a news : afficher les news 
a tvseries : afficher les séries TV 


a striptags (optionnel) : supprime les tags HTML des paramètres valeurs passées en paramètre 


a Exemple t@rtte://api.allocine.fr/rest/v3/movie?partner=QUNXZWItOWxsbONpbuk&code=61282sprofile=largesmediafmt=mp4- 
lc&format=)sonéfilter-=moviesgstriptags=synopsis,synopsisshort 


Critiques sur un film (presse et public) : reviewlist 


= Paramètres 
a partner : code partenaire (QUNXZWItOWxsbONpbuk pour l'application Android) 
a type : type (valeurs possibles : movie, ???) 
a code : identifiant du film (entier) 
a filter : type de critique, presse (desk-press) ou public (public) 
a count (optionnel) : nombre de critiques à renvoyer (entier) 
a page (optionnel) : numéro de la page de résultats à afficher (10 résultats par page par défaut) 
a format (optionnel) : renvoie le résultat au format JSON ou XML (json ou xml) 


a Exemples : 
= @nttr://cpi.allocine.fr/rest/v3/reviewlist?partner=QUNXZWItOWxsbONpbuketype=moviescode=61282&filter=publicecount=30&format=ison 


= @:::c: //api.allocine.fr/rest/v3/reviewlist?partner-QUNXZWItOWxsbONpbuké&type=-moviesfilter-desk- 
pressécode-612828count-308&format-json 
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A noter qu'une autre façon de construire la requête existe. Il faut pour cela utiliser le paramètre subject : Qnttp://api.allocine.fr/rest/v3/reviewlist? 


partner=-QUNXZWItQOWxsbONpbuk&filter-publicéesubject-movie:61282&format-json 
Le reste des paramètres reste inchangé. 


Horaires des cinémas : showtimelist 


a Paramètres 
a partner : code partenaire (QUNXZWItOWxsbONpbuk pour l'application Android) 
a zip: code postal de la ville 
a lat : coordonnée latitude du cinéma 
a long : coordonnée longitude du cinéma 
a radius : rayon autour du point désigné (entre 1 et 500 km) 
a theaters : liste de codes de cinémas (séparé par une virgule, exemple: P0728, P0093) 
a location : chaîne représentant le cinéma 
a movie (optionnel) : identifiant du film (si non précisé, affiche tous les films) 
=a format (optionnel) : renvoie le résultat au format JSON ou 
a date (optionnel) : date au format YYYY-MM-DD (si non précisé, date du jour) 


.(json ou xml) 


a Exemples : 


= @rttr: //api.allocine.fr/rest/v3/showtimelist?partner-QUNXZWItOWxsbONpbuk&format-)soné&radius=-508&lat-49.01763948long=-0.3498428 


= @:t:c: //api.allocine.fr/rest/v3/showtimelist?partner-QUNXZWItQOWxsbONpbukeq=61282&format-xmlétheaters-P0728 
= @nttr://2pi.allocine.fr/rest/v3/showtimelist?partner=QUNXZWItOWxsbONpbukeq=61282&format=jsonélocation=ugc#20mondeville 
a @ntte://2pi.allocine.fr/rest/v3/showtimelist?partner=QUNXZWItOWxsbONpbuksq=61282&format=json&zip=14000 


Informations sur une vidéo : media 


* Paramètres 
a partner : code partenaire (QUNXZWItOWxsbONpbuk pour l'application Android) 
a code : identifiant de la vidéo (entier) 
a profile (optionnel) : degré d'informations renvoyées (valeurs possibles : small, medium, large) 
a mediafmt (optionnel) : format vidéo 
a flv: FLV / H.264 
a mp4-lc : MP4 / H.264 Baseline Profile, Low Complexity, with splashscreen 
= mp4-hip : H264 High Profile, with splashscreen 
a mp4-archive : MP4 / H.264 High Profile, for archive 
a mpeg2-theater : G-2 720p 
a mpeg2 : MPEG-2 Main Profile 


a et sûrement d'autres mais je n'ai pas le code correspondant … 


= Exemples : 
=a @ittr://spi.allocine.fr/rest/v3/media?partner=QUNXZWItOWxsbONphbuk&code=19135625&profile=largesmediafmt=mp4-lcsformat=json 


Informations sur une personne : person 


* Paramètres 

a partner : code partenaire (QUNXZWItOWxsbONpbuk pour l'application Android) 

a code : identifiant de la personne (entier) 

= profile (optionnel) : degré d'informations renvoyées (valeurs possibles : small, medium, large) 
mediafmt (optionnel) : format vidéo 

a flv: FLV / H.264 

a mp4-lc : MP4 / H.264 Baseline Profile, Low Complexity, with splashscreen 

=a mp4-hip : H264 High Profile, with splashscreen 

a mp4-archive : MP4 / H.264 High Profile, for archive 

s eg2-theater : MPẸG-2 720p 


m 
a m 
a et sûrement d'autres mais je n'ai pas le code correspondant ... 


filter (optionnel) : filtrer selon un type de résultat (énumeration de termes séparés par des virgules) 
a movie : afficher les films correspondant à la recherche 
a theater : afficher les cinémas 
a person : afficher les acteurs, réalisateurs, etc. (personnes) 
a news : afficher les news 
a tvseries : afficher les séries TV 
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Exemples : 


Filmographie d'une personne : filmography 


* Paramètres 

= partner : code partenaire (QUNXZWItOWxsb0Npbuk pour l'application Android) 

a code : identifiant de la personne (entier) 

a profile (optionnel) : degré d'informations renvoyées (valeurs possibles : small, medium, large) 

a filter (optionnel) : filtrer selon un type de résultat (énumeration de termes séparés par des virgules) 
a movie : afficher les films correspondant à la recherche 
a theater : afficher les cinémas 
a person : afficher les acteurs, réalisateurs, etc. (personnes) 
a news : afficher les news 
a tvseries : afficher les séries TV 


a Exemples : 
@::ttr: //api.allocine.fr/rest/v3/filmography?partner-QUNXZWItOWxsbONpbuksprofile=-mediumecode=41339sfilter-moviesformat-j)son 


@hbhttp: //api.allocine.fr/rest/v3/person?partner=QUNXZWItQOWxsb0Npbuk&profile=large&code=41339&mediafmt=mp4-lc&filter=movie&format=json 
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Liste des films en salle : movielist 
= A @httr: //api.allocine.fr/rest/v3/movielist 
* Paramètres 
a partner : code partenaire (QUNXZWItOWxsbONpbuk pour l'application Android) 
a code : identifiant de la personne (entier) 
a count (optionnel) : nombre de films à renvoyer (entier) 
= page (optionnel) : numéro de la page de résultats à afficher (10 résultats par page par défaut) 
a profile (optionnel) : degré d'informations renvoyées (valeurs possibles : small, medium, large) 
a filter (optionnel) : filtrer selon un type de résultat (énumeration de termes séparés par des virgules) 
a nowshowing : afficher les films actuellement à l'affiche 
a comingsoon : afficher les films à paraitre 
a order (optionnel) : ordre de tri des résultats 
a datedesc : classement anti-chronologique 
a dateasc : classement chronologique 
a theatercount : classement par nombre de salles 
= toprank : classement par popularité 
a format (optionnel) : renvoie le résultat au format JSON ou XML (json ou xml) 
= Exemples : 
a Films en salle triées par nombre de salles :@rttr://api.allocine.fr/rest/v3/movielist? 
partner-QUNXZWItOWxsbONphuk&ecount=258filter-nowshowingéepage-lsorder-theatercounté&format-]json 
a Films en salle triées par date de sortie :@rttr://api.allocine.fr/rest/v3/movielist? 
partner=QUNXZWItOWxsbONphukecount=25&filter=nowshowingepage=léorder-=datedesceformat=;son 
a Films à paraitre les plus attendus :@rttr://api.allocine.fr/rest/v3/movielist? 
partner=QUNXZWItOWxsbONphukéecount=25&filter=comingsoonépage=le&order=toprankeformat=;json 
= Films à paraitre triés par date :@ittr://api.allocine.fr/rest/v3/movielist? 
partner-QUNXZWItOWxsbONpbukscount=25sfilter-comingsoonépage-=1lsorder-dateasc&format-)son 
Liste des cinémas : theaterlist 
a URL: @rttr://api.allocine.fr/rest/v3/theaterlist 
= Paramètres 
a partner : code partenaire (QUNXZWItOWxsbONpbuk pour l'application Android) 
=a zip: code postal de la ville 
a lat : coordonnée latitude du cinéma 
a long : coordonnée longitude du cinéma 
a radius : rayon autour du point désigné (entre 1 et 500 km) 
a theater : code du cinéma (exemple: P0728) 
a location : chaîne représentant le cinéma 
a format (optionnel) : renvoie le résultat au format JSON ou XML (json ou xml) 
a Exemples : 
= @::tte: //api.allocine.fr/rest/v3/theaterlist?partner=QUNXZWItOWxsbONpbuké&count=25epage=1élat-49.017168258&long=- 
0.34993468format-json 
s @::tte ://api.allocine.fr/rest/v3/theaterlist?partner-QUNXZWItOWxsbONpbuk&count=25spage-18zip=-14000&format-json 
Informations sur une série TV : tvseries 
a URL: @nttr://api.allocine.fr/rest/v3/tvseries 
a Paramètres 
a partner : code partenaire (OUNXZWItOWxsbONpbuk pour l'application Android) 
a code : identifiant de la série (entier) 
a profile (optionnel) : degré d'informations renvoyées (valeurs possibles : small, medium, large) 
a mediafmt (optionnel) : format vidéo 
a flv : FLV / H.264 
=a mp4-lc : MP4 / H.264 Baseline Profile, Low Complexity, with splashscreen 
= mp4-hip : H264 High Profile, with splashscreen 
a mp4-archive : MP4 / H.264 High Profile, for archive 
a mpeg2-theater : MPEG-2 720p 
=a mpeg2 : MPEG-2 Main Profile 
a et sûrement d'autres mais je n'ai pas le code correspondant ... 
a format (optionnel) : renvoie le résultat au format JSON ou XML (son ou xml) 
a striptags (optionnel) : supprime les tags HTML des paramètres valeurs passées en paramètre 
= Exemple :@rttr://api.allocine.fr/rest/v3/tvseries?partner=QUNXZWItOWxsbONphuk&code=223sprofile=largesmediafmt=mp4- 
lcsformat-xmlestriptags-synopsis, synopsisshort 
Informations sur la saison d'une série TV : season 
a URL: @rttr://api.allocine.fr/rest/v3/season 
= Paramètres 
a partner : code partenaire (QUNXZWItOWxsbONpbuk pour l'application Android) 
a code : identifiant de la saison (entier) 
a profile (optionnel) : degré d'informations renvoyées (valeurs possibles : small, medium, large) 
=a mediafmt (optionnel) : format vidéo 
a flv : FLV / H.264 
=a mp4-lc : MP4 / H.264 Baseline Profile, Low Complexity, with splashscreen 
= mp4-hip : H264 High Profile, with splashscreen 
= mp4-archive : MP4 / H.264 High Profile, for archive 
a mpeg2-theater 2 720p 
B 
= 
a format (optionnel) : renvoie le résultat au format JSON ou XML (json ou xml) 
a striptags (optionnel) : supprime les tags HTML des paramètres valeurs passées en paramètre 
a Exemple : @http ://api.allocine.fr/rest/v3/season?partner=QUNXZWItOWxsb0Npbuk&code=12277&profile=large&mediafmt=mp4- 
lcáformat=xml&striptags=synopsis, synopsisshort 
Informations sur l'épisode d'une série TV : episode 
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L @:tte: //api.allocine.fr/rest/v3/episode 
a Paramètres 
a partner : code partenaire (QUNXZWItQOWxsbONpbuk pour l'application Android) 
a code : identifiant de la saison (entier) 
a profile (optionnel) : degré d'informations renvoyées (valeurs possibles : small, medium, large) 
=a mediafmt (optionnel) : format vidéo 
a flv : FLV / H.264 
= mp4-lc : MP4 / H.264 Baseline Profile, Low Complexity, with splashscreen 
= mp4-hip : H264 High Profile, with splashscreen 
=a mpd-archive : MP4 / H.264 High Profile, for archive 
mpeg2-t 


= et sûrement d'autres mais je n'ai pas le code correspondant … 


a striptags (optionnel) : supprime les tags HTML des paramètres valeurs passées en paramètre 


a Exemple i @bttp://api .allocine.fr/rest/v3/episode?partner-QUNXZWItOWxsbONpbuk&code=233016&profile-largesmediafmt-mp4- 
lcéformat-xmlestriptags-synopsis, synopsisshort 


Ils se servent de l'API 


Si jamais vous tombez sur cette page et que vous vous servez de cette je me ferais une joie de lister votre application ici. 


a EzTvix : @http://blog.eztvix.info 

a Str9am : @http://www.abysscorp.org/project/str9am 

a Ma filmothèque : @http://ma-filmotheque.fr 

= WebMovieManager : @http://sourceforge.net/projects/webmoviemanager/ 

a AloWMC : @hnttps://sites.google.com/site/allowmc/home 

a Lib Ruby : @https://rubygems.org/gems/allocine_parser & @https://github.com/mlamarque/allocine 

a Lib DotNet : @http://allocineapi.codeplex.com/ 

= Application Android CinéMinute : @nttps://play.google.com/store/apps/details?id=info.toyonos.cineminute 
= Cinegeek : @nttp://cinegeek.alwaysdata.net/ 


= Application Android CinéTime : @https://play.google.com/store/apps/details?id=fr.neamar.cinetime 
a MovieFlow Android : @hnttp://www.movieflow.net/ 
= Module Node.js : @https://github.com/leeroybrun/node-allocine-api 


Remarques 


Il y a peut-être (sûrement) des oublis, donc si vous trouvez quelque chose qui ne va pas ou alors un nouveau service, contactez moi via le formulaire de contact ou bien directement sur mon mail 
Ejerome.groven@gmail.com 


Remerciements 


Merci à tout ceux qui m'ont contacté pour me signaler des nouveaux services, comme Olivier B. pour m'avoir mis sur la piste pour les séries © 


[A Derniers changements Œ Afficher le texte source Anciennes révisions {Connexion 


BE EE 
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